BCI NET 2/BCI NET 2.iso/archives/applications/databases/gentreefwdocs.lzh/GenTree/Docs/GenTree.Doc

Final Write Document | 1995-03-16 | 432.3 KB | 3,213 lines

GenTree v1.5
The Genealogical/Family Tree Program










Copyright © 1995, Thomas G. Grubb.
All Rights Reserved.


Table of Contents
Illustrations


1
Introduction


1.1
What is GenTree?

1
1.2
Copyright Notice And Disclaimer

1
1.3
Major Feature List

1
1.4
System Requirements

2
1.5
Installation

2
1.6
Document Organization

3
2
GenTree Database Organization


2.1
GenTree Database

4
2.2
Media Databases

4
2.3
Member Records

5
2.3.1
IDs

5
2.3.2
Personal Media Databases

5
3
Tutorial


3.1
Starting GenTree

6
3.2
Creating Your Family Tree

6
3.3
Adding Pictures, Sounds, Notes, And Sources

11
3.4
Saving Your Family Tree

13
3.5
Displaying Pedigree Charts, Descendant Charts, And Family Groups

14
3.6
Printing Your Family Tree

15
4
Reference


4.1
Main Window

17
4.1.1
Menus

17
4.1.2
AppEvent

19
4.2
Member Information And Data Entry Windows

19
4.2.1
Buttons

20
4.2.2
Menus

20
4.2.3
Windows

22
4.2.3.1
Personal Information Window


22
4.2.3.2
Family Information Window

22
4.2.3.3
Supplemental Information Window

23
4.3
Media Databases

23
4.3.1
Global Media Databases

23
4.3.2
Personal Media Databases

26
4.3.3
Source Data Entry Window

27
4.3.3.1
Buttons

27
4.3.3.2
Fields

28
4.4
Genealogical Charts

29
4.4.1
Pedigree Charts

29
4.4.2
Descendant Charts

29
4.4.3
Family Groups

30
4.4.4
Printing Charts

30
4.5
MomentED

31
4.6
Preferences

34
4.6.1
Defaults

34
4.6.2
Changing The Defaults

37
4.7
Joining GenTree Databases

37
4.8
Printing GenTree Databases

38
Appendix A
Date Formats


Appendix B
GEDCOM


Appendix C
GenTree Supported File Formats


Appendix D
Future Plans


Appendix E
About The Author And Development


Appendix F
Suggestions, Comments, And/Or Bug Reports


Appendix G
Version History


August 1993
Original Release: GenTree v1.0

G1
March 1995
GenTree v1.5

G1


Illustrations

Main
"New" Menu item

6
"Update" Menu item

7
Tutorial - Margery Ann Grubb

8
Tutorial - After entering child

8
Tutorial - Husb./Child

9
Tutorial - Select Father

10
Tutorial - Search Requester

10
Tutorial - Spouse Record Changed

11
Tutorial - Media Buttons

11
Tutorial - Picture Media

11
Tutorial - Picture Media DB

12
Tutorial - Source Data Entry

13
Tutorial - Descendant Chart Req

14
Tutorial - Margery's Desc. Chart

14
Tutorial - Print Requester

15
Main Window

17
List Requester

20
Media Buttons

20
Navigation Buttons

20
Media DB Window

24
Personal Media Window

26
Source Data Entry Window

27
Pedigree Chart Requester

29
Descendant Chart Requester

29
Family Group Chart Requester

30
Print Requester

30
MomentED's Find Requester

32
MomentED's Change Requester

32
MomentED's Margins Requester

33
Preferences Window

34
Join Requester

37
Print Requester

38


1

Introduction

1.1

What is GenTree?


The Genealogical/Family Tree Program for the Amiga Series of computers
is a multi-media program for creating, organizing, and maintaining family
trees.  Using GenTree, you can create family trees containing unlimited number
of members.  It organizes your data, binding text with graphics, sounds, and
annotated text.  You can create and print pedigree charts, descendant charts,
and family groups.

1.2

Copyright Notice And Disclaimer


This manual and the software described in it are Copyright © 1994 Thomas G.
Grubb.  All rights reserved.  The software is delivered "as is", you rely on
the program and results solely at your own risk.  The software is shareware.
If you like it and use it, please send $20 to:

Thomas G.  Grubb
15439 Empress Way
Bowie, Md. 20716 USA


When you register the software, you will be mailed (either electronically or
traditionally) the program
GEDCOMConverter
.  This is a utility which converts GenTree databases to the Genealogical Data
Communications (GEDCOM) Standard files.


The software must be distributed with this notice and all files intact.  You
are free to copy and distribute this archive.  No fees may be charged beyond a
nominal copying fee (less than $6).

1.3

Major Feature List

GenTree is a very powerful genealogical program.  Some features are:
·

Provides unlimited number of members (limited by ram for the central
database file) distributed over an unlimited number of storage media.
·

Provides unlimited number of pictures (displayable on the computer) that may
be associated with members.  You can compile a family album for your family.
Pictures, brushes and anim brushes are all directly supported by GenTree.  With
the correct player, you can show 24-bit IFF and full screen animations.
·

Provides unlimited number of sounds (playable on the computer) that may be
associated with members.  Listen to digitized samples of your relative's voices
or even their favorite songs.
·

Provides unlimited number of annotated notes about member records.
·

Provides unlimited number of source references about member records.
·

Provides member records that may have an unlimited number of spouses, children,
occupations, and residences.
·

P
rovides compatibility with other genealogical programs by converting GenTree
databases from and toGEDCOM Files (this feature is provided through the utility
you receive when you register).
·

Runs under AmigaDOS 1.3, 2.x, and 3.x.
·

Runs on the Workbench (in any resolution) to save memory.
·

Supports AppEvents under AmigaDOS 2.0+.
·

Uses Preferences to allow you to configure GenTree for your use including
Bitmapped and Outline fonts.  Also, you may specify your own favorite picture
viewer in order to take advantage of picture formats like JPEG or AGA.
·

Saves Preferences with each database allowing different databases to have
different preferences.
·

Creates Pedigree Charts as many generations deep as desired (or practical).
·

Creates Descendant Charts as many generations deep as desired (or practical).
·

Creates Family Groups.
·

Prints your entire, or a subset, GenTree database in many different ways:
individual names, birth and death information, family information, supplemental
information, lists of pictures or sounds, notes, and sources.
·

Saves changes to the database in memory so that your modifications are not
final until you save them.

1.4

System Requirements


GenTree requires at least 2 Meg of memory to run.  The program works well under
AmigaDOS 1.3, 2.x, or 3.x.  In addition, GenTree supports the 2.0 App Event.
The program may be used from a floppy or a hard disk.

Note: It is strongly recommended that you use a hard disk and an accelerator.
While GenTree will work using floppies and the 86000 CPU, response time is
greatly increased (and user frustration decreased) with HD and a 68020+.

1.5

Installation


GenTree is distributed as a LZH archive.  Simply extracting the archive will
create the proper directories and files needed by the program.  The
directories; Pictures, Sounds, Notes, Sources, and Persons; may be placed
anywhere.  In fact, each directory could be a separate disk.

1.6

Document Organization

This document is divided into several sections and appendices:
·

Introduction - The section you are reading now.  It describes GenTree and its
features in a basic way.  Cost, system requirements, and installation are
included as well.
·

GenTree Database Organization - Contained in this chapter are structures  and
variables used by the program.  They are provided to help give a conceptual
understanding of GenTree's workings.
·

Tutorial - This section guides you in making a family tree.  It provides a
quick  start to using GenTree.  You learn how to start GenTree, create a family
tree, add pictures, sounds, notes and sources to your family tree, save your
work, display pedigree and descendant charts, and print your family tree.
·

Reference - This section provides a reference to all the functions of the
GenTree program.  Each screen, its menus, buttons, and purpose are detailed.
·

Appendices - The appendices discuss date formats, GenTree Genealogical Data
Communications (GEDCOM) standard support, future plans, history, and error
messages.

2

GenTree Database Organization


GenTree divides data into 3 basic components.  First, there is the GenTree
database file.  This file lists all members (and their associated member
records) in the current database, the media databases to use with the member
records, and other general information.  Second, there are member records
themselves which contain information about 1 member each: name, sex, birth
date, spouses, children, residences, etc.  Finally, there are Media databases
which track all multimedia (pictures, sounds, text) support files used by the
current GenTree database.

2.1

GenTree Database


The GenTree database is the main "product" GenTree produces.  It tracks every
member in the database and where their member records are located.  It also
points to the media databases used by the member records.  The GenTree database
is the limit to the number of member records you may create.  The entire
database file must be able to fit into memory.

2.2

Media Databases


There are four media DBs produced by GenTree: pictures, sounds, notes, and
sources.  Each DB tracks all the files of its type for the current database.
They contain a logical and a physical name for each file.  The physical name
points to the exact location on disk of the media file.  The logical name is
what is used to refer to the file within your program.


For example, you could have a picture file named TGrubb.Pic on your DH0: hard
drive.  The physical filename for the file would be "DH0:TGrubb.Pic." However,
in the program you refer to it with a logical name (255 characters Max) like
"Thomas G.  Grubb, Year 1993, Age 26, at the annual family picnic."


The Source Media database is slightly different than the others.  Like the
other media types, you have a logical name and possibly a physical file.  But,
sources also contain many other fields to completely define the source
reference: classification, originator information, pubilication information,
etc.


The file formats supported by GenTree are listed in Appendix C.

2.3

Member Records


Each member in your family tree will have a member record.  A member record
contains personal information about that member: name, sex, birth date, family,
religion, ...  essentially all the information you enter in the Data Entry
Windows (the Personal, Family, and Supplemental windows defined in the
reference section).  Two important pieces of member information are a member ID
and personal media databases.

Note: Member records are tracked in the GenTree Database for the family.  As
such, member records could be saved anywhere i.e.  you are not limited to 1
floppy or even 1 hard drive for all your member records.

New member records are saved in your current default persons directory.  The
default persons directory is changed in the preferences screen.  It only
affects new records.

2.3.1


IDs


Member IDs uniquely identify a member of your family tree.  Conceivably, you
could have two members with the same surname, givenname, and birth date so
these cannot be used as unique identifiers.  The member ID is used by GenTree
to track that member.


Ordinarily, you won't have to worry about member IDs.  GenTree assigns them
automatically when you create a member.  Even when you need to specify a member
from the database, you may use requesters that list relevant members to select.


2.3.2


Personal Media Databases


Each member has his/her own personal media databases.  The personal media
databases are used to associate media files (pictures, sounds, notes, and
sources) to the given member.  In actuality, these databases point to media
files tracked in a Media DB.  This is a powerful feature since you can refer to
the same file in the same manner from several different member records.  Not
only does it help consistency between
members, it saves disk space.


For example, you could have a picture of your family with a logical name
"Family Reunion, August 7th 1992".  Each member of the family could then point
to this file in the Picture Media DB using their personal picture DB.

3

Tutorial

3.1

Starting GenTree


You can start GenTree from the Workbench or the CLI.

Workbench: Open the drawer in which GenTree is installed.  Double-click on the
GenTree icon.  This procedure loads GenTree with a new database.
Alternatively, if you have a database already created, double-click on your
project icon and GenTree will load with your family tree already loaded.

CLI: Change directories until you are in the GenTree directory.  Type "GenTree"
to load the program.  Type "GenTree Path&Filename" to load a previously created
database.

3.2

Creating Your Family Tree


To create a new family tree, select the New menu item (see figure) from the
main window's project menu.  If you have just started GenTree you can skip this
step.  For the tutorial, we are going to create the following family:

Godsey, Margery Ann


Born: 28-Jan-1932

Died:
Father:

Godsey, Keith Foster

Born: 6-Jul-1897

Died: 16-May-1980
Mother:

Arnold, Leah Placida

Born: 23-Apr-1892

Died: 23-Mar-1972
Spouse(s):

Grubb, Samuel Parry, Jr.
Start Date:

About 1957


 End Date:

About 1970
Wedding Location: Falls Church, Virginia
Children:
Grubb, Samuel Parry, III
Grubb, Thomas Gerard

Grubb, Alexandria Kathleen


Born: 3-Jan-1988

Died:
Father:

Grubb, Samuel Parry, III
Mother:

Meeks, Julie Lynette

Grubb, Elizabeth Michelle


Born: 3-Sep-1990

Died:
Father:

Grubb, Samuel Parry, III
Mother:

Meeks, Julie Lynette

Grubb, Samuel Parry, III


Born: 3-Jul-1959

Died:
Father:

Grubb, Samuel Parry, Jr.
Mother:

Godsey, Margery Ann
Spouse(s):

Meeks, Julie Lynette
Start Date: 27-Aug-1983


End Date:
Wedding Location: Gatesville, Texas
Children:
Grubb, Alexandria Kathleen
Grubb, Elizabeth Michelle

Grubb, Samuel Parry, Jr.


Born: About 23-Oct-1931

Died:
Father:

Grubb, Samuel Parry
Mother:

Rhodes, Helen
Spouse(s):

Godsey, Margery Ann
Start Date: About 1957
End Date: About 1970
Wedding Location: Falls Church, Virginia
Children:
Grubb, Samuel Parry, III
Grubb, Thomas Gerard

Grubb, Thomas Gerard


Born: 7-Aug-1966

Died:
Father:

Grubb, Samuel Parry, Jr.
Mother:

Godsey, Margery Ann

Meeks, Julie Lynette


Born: 15-Feb-1962

Died:
Spouse(s):

Grubb, Samuel Parry, III
Start Date: 27-Aug-1983



End Date:
Wedding Location: Gatesville, Texas
Children:
Grubb, Alexandria Kathleen
Grubb, Elizabeth Michelle


To enter members into family trees, select the Update Person menu item (see the
figure above) from the database menu (main screen).  This will bring up the
personal information screen.  The personal information screen allows you to
enter a member's name, sex, birth date & place, and death date & place.  On
entering the screen, the cursor will be in the Given name field.  Type the
following (<cr> is a carriage return):
Margery Ann<cr>
Godsey<cr>
f<cr>
28 Jan 1932<cr>


(If you typed everything correctly, your screen should look like thefigure to
the below.) OK, let's enter Margery's family information.  Click the button
labeled Family Info on the right of the screen.


The Family Info screen allows you to connect the members of your family tree
through the various relationships: spouses, children, father, and mother.  A
member may have as many spouses or children as needed.  You can specify
relationships with other members already defined in the database.
Alternatively, GenTree allows you to enter names from this screen.  The program
will automatically create new records for you, and each member will have the
correct links entered.  It saves time to let GenTree do the work, so for our
tutorial enter the following information for the spouse:

Samuel Parry, Jr.<cr>
Grubb<cr>
Falls Church, Virginia<cr>
about 1957<cr>
about 1970<cr><cr><cr>


Your cursor should now be in the given name field for the children.  If it
isn't, select that field with your mouse.  Now we want to enter the children.
Enter "Samuel Parry, III<cr>".  After you hit the carriage return, GenTree
automatically filled in the surname for the child.  GenTree automatically
enters the surname of the current record if the member is male or the surname
of the current spouse.  Since this is what we want, let's skip the field and
press return.  Enter "M<cr>" in the gender field.  Enter the birth date (July 3
1959).  The screen should now look like the figure at the left.  Finish the
family information by typing in Margery's father and mother (Keith Foster,
Godsey, July 8 1897, May 16 1980, Leah Placida, Arnold, April 23 1892, and
March 23 1972).  At this point, GenTree has not created any new records.  You
can always tell when a record is in the database because it has been assigned
an ID.  To create the records, you just have to perform any action which
requires GenTree to clear the screen.  For our purposes, we will select Verify
from Record menu.  Usually, Verify checks your current member record for
correct information.  However, since we added a spouse, you will instead see a
requester asking if you want this spouse to be the husband of Margery's
children (see figure).  Select Yes with the mouse.  Next, GenTree shows another
requester asking you if you want the parents you added to be married.  This
serves our purposes nicely so select Yes again. Finally, after a few moments
GenTree will display an information requester stating there are no errors (If
you do get errors, check the dates and other data you entered.)


We forgot to add one of Margery's child (Thomas Gerard).  We can add children
by selecting the button labeled Children (1 of 1) which would clear the child
fields for a new child.  This button is a radio button (as is the Spouse (1 of
1) button) which allows us to cycle through all the current children and create
new children.  However, at this point, if we added a child this way, only the
mother link would be updated.  The father link would not be made because
GenTree only makes these links when records are created (if you added another
spouse, the new child could have the new spouse as father added automatically).
 Instead, what we are going to do is duplicate the child Samuel Parry, III's
record.  Duplicating a record copies ALL information (names, dates,
supplemental information, and family links) except for spouse information.
First, go to the child record by select Child...  from the record menu.
Duplicate is only available as an option from the Record menu of the Personal
info screen.  Therefore, select the Personal Info button to go to that screen.
Select Duplicate from the record menu.  The only changes you will see is that
the ID will have changed.  Also, the window title will change to reflect the
member record added to the family tree.  Change the given name to "Thomas
Gerard" and the birth date to "August 7 1966" (Right-Amiga-X will clear the
current field).  That's it.  If you want, you can go to the family information
screen to verify the links.


Our next step will be to add the children of Samuel Parry, III: Alexandria and
Elizabeth.  First, let's enter Alexandria's information.  From the Personal
Information screen, select New under the Record menu.  You will see a blank
record with a new ID (in this case ID 7).  Enter "Alexandria Kathleen<cr>",
"Grubb<cr>", "Female<cr>" (or just "f"), and "January 3, 1988<cr>".  You'll
notice that every time you enter a date,
GenTree formats the date into a standard type: DD-Mon-YYYY.  This tutorial has
had you enter the date in many different formats to show the power of GenTree's
date recognition.


Press the Family Information button to go to Alexandria's family.  So far, it's
blank.  Click on the button labelled Father.  This button will bring up a list
requester (see figure) containing all of the members in the database that could
be Alexandria's father (based on sex and age).  Double-click on Samuel Parry,
III to select him as the father.  GenTree will automatically fill in the ID,
name, and date's for the father fields.  The list requesters that GenTree
provides are very handy if you forget the ID of a family member.  If you had
remembered Samuel Parry, III's ID number you could also have entered the ID in
the father ID.  After hitting return, GenTree would have filled the father
fields from the family member with that ID.  If the ID didn't exist, no fields
would be filled.  GenTree would assume you are entering a new member and are
specifying what you would like the ID to be.  Member list requesters are
available for spouses, children, father, and mother.


Now, let's enter the mother's information (Julie Meeks).  She doesn't exist yet
so we can't use the list requester.  Type in "Julie Lynette<cr>", "Meeks<cr>",
"Feb 15, 1962<cr>".  Select the Personal Info button.  A requester will appear
saying the father's information has changed (we added a child); do we want to
change his record?  Select Yes.  Then, a requester will appear asking if you
want Alexandria's parents to be married.  Again select Yes.  When the Personal
Information window appear, duplicate the record.  Change the given name to
"Elizabeth Michelle" and the birth date to "September 3, 1990".


The last bit of information we need to enter is the marriage information for
Julie Meeks and Samuel Parry Grubb, III.  You could use the Father or Mother
menu item from the record menu, but for the tutorial we are going to use
GenTree's search abilities.  Select the Search menu item from the record menu
or the Search button (the magnifying glass at the bottom of the screen).  After
a few moments the Search requester will appear (see figure).  The Search
requester allows you to search for members in the database for which all data
that you enter matches.  Alternatively, you can depress New and the requester
will return you to the Person Information screen with a new record to enter.
Let's look for Samuel Parry Grubb, III's record.  Enter "Parry" in the name
field (case does not matter) and "After 1950" in the birth date field.


After pressing the Search button, GenTree will search your database for all
records that have Parry in their names and who were born January 1st, 1951 or
later (members with blank birth dates would also be returned).  GenTree
displays the Personal Information screen.  Using the left and right arrows at
the bottom of the screen (or the Next and Previous menu items) would scroll you
through all the records satisfying
the query.  In this case, only 1 record matches the query so the arrows are
disabled.  Go to the Family Information screen.  As you can see, GenTree has
updated the family member's information (added Julie as a spouse and Elizabeth
as a child).  Change the marriage information: "Gatesville, Texas" for the
location and "August 27, 1983" for the
wedding date.


Select the Verify menu item.  GenTree will inform that the marriage information
has changed, and, asks if you want the spouse's marriage information changed
(see figure).  Select Change.  If you didn't mean to change anything you could
have selected Cancel.  Selecting No will leave the spouse's information
untouched (for instance, if the spouse had a different reason for the end of
the marriage).  After a moment, verify will come back with no errors.


OK, we have finished entering the member information.  In the next section, you
will learn how to attach media (pictures, sounds, notes, or sources) to your
family tree members.

3.3

Adding Pictures, Sounds, Notes, And Sources


GenTree allows you to connect pictures, sounds, notes, and sources (references)
to your family members.  The four buttons at the bottom left of the Personal,
Family, or Supplemental Info screens (see figure) are for the different media
(from left to right): pictures, sounds, notes, and sources.  Clicking any of
the Media icons will display the Personal Media window.  This window is used to
choose the pictures you want from the current family tree's media databases.


Assuming you are still in Elizabeth's Personal Info screen, click the Picture
Icon.  The Personal Media window (see figure) allows you to attach media (in
this case pictures) to the current member.  The list at the left of the window
displays the logical names for all pictures currently associated with the
member.  The buttons at right allow you to add to the list, remove from the
list, and search the list. If we were adding notes or sources, there would be
two other buttons: Edit loads the current selected name into the editor (the
editor is chosen through preferences), and Editor calls the chosen editor
without any files (to allow you to create new notes).  The final button, Media
DB, brings up the Media DB window.  To perform an operation, we can click on
the button or press the key underlined in the button's label.

Note: The important thing to remember is that the Personal Media Window only
allows you to work with Media ALREADY in the family tree.  You must define
media using the Media Database Window.  Another important thing about media
records: you do not work with files from the system, rather logical names refer
to the media in your family tree.


Since we don't have any media stored in our family tree, click the Media DB
button (or press "M") so that we can add some.  See the figure below.  The
Media DB window looks a lot like the Personal Media window.  From here, you
essentially make a catalog of all the files you want to use with your family
tree.  You can add new media records, edit text media files, update entries in
the database, search the database, and bring up the editor.  Again, the Edit
button and Editor button are only available with note and source media.  There
is no provision for deleting entries.  You can effectively delete entries by
using Update.  Note that this is the Picture Media DB shown.  The Personal
Media window always calls up the relevant Media DB window.


Let's create some entries.  Select the New button (or press "N").  Immediately,
a requester will appear asking you to select a physical filename.  Select any
file.  Don't worry about whether it's an actual picture file; GenTree doesn't
care until it actually has to display the files.  (This feature allows you to
add pictures in formats GenTree cannot show and use your own picture viewer
through the preferences).  Select the file and press OK.  Now a logical name
requester appears.  A logical name is a 255 character string that refers to
this file.  You will use this logical name throughout the program instead of
the physical filename.  It provides you with a level of data transparency.  If
it's easier, just think of it as a unique comment about the file.  Put anything
you like in the requester, say "Elizabeth M.  Grubb, Age 2, at Damascus House
(12/92)" and click OK.  Select a few more pictures if you like.
Double-clicking on items in the list request will display the picture (or play
the sound, or view the note,...).  Double-clicking also works in the Personal
Media window.  When you are done, select OK to exit the window.  Selecting
Cancel will lose all your changes.


Now we are back at the Personal Media window.  All the changes in the Media DB
window will not show up here.  Using the Add button (or "A" key), add a picture
(or two) for Elizabeth.  Click OK to save your changes.


The procedures described above work the same for picture, sound, and note
media.  However, the source media records are treated a little differently.
Let's return to the Media Database Window for sources.  Select the Source icon
(the footprint on a page icon at the bottom of the Personal Info window, Family
Info window, or Supplemental window).  This action brings up the
Personal
Media Window.  Select the Media DB button to enter the Media Database Window.


Media database records for sources are considerably more detailed.  This allows
you to enter exact information describing the sources of information you have
rather than a loose collection of text in some file.  Sources are one of the
most important pieces of genealogy.  Without adequate documentation of your
sources, other genealogists cannot trust your information.  GenTree allows you
to enter many fields for sources: classification, title, quality, fidelity,
originator information to just name a few.  Also, like other media types, you
can point to a physical media file on disk.


To illustrate the difference, select the New button (or press the "n" key) in
the Media Database window.  The Source Data Entry Window will appear (see
Figure).  It's a bewildering number of fields at first.  Fortunately, GenTree
helps you in this window as well by providing lists.  Click to the left of many
of the fields and available options will appear.  Select Cancel and navigate
your way back to the Personal Information Window.

3.4

Saving Your Family Tree


GenTree keeps all work within memory.  If you turned off your computer right
now (or quit), all of your changes would be lost.  Let's return to the main
window.  Select Return to Main from the Project Menu (if you are in the
Personal Info Window, the close gadget will also return you to the main
window).


Select Save from the Project Menu of the main window.  A file requester will
appear asking you where you want to place your family tree (and media
databases).  Enter a path and filename and select OK.  After a few moments,
your family tree will have been saved.  GenTree saves your family tree and
media databases in the directory you specified.  Each member also has a file
containing their unique information.  These files
are saved in the current Persons Directory (specified in preferences).  As disk
space fill up, you will want to change the Persons directory so that any new
members will be saved somewhere else (GenTree will prompt you for a new name if
the disk fills up or there is some other error saving a member file).  It is a
good idea to have one directory exclusively for the member files.  Note that
you also free up memory by saving your work to disk.

Warning: Do NOT delete, rename, or move member files.  GenTree stores their
physical location in the family tree DB.  If GenTree cannot find a file, it
will display a file requester asking you where it is.  However, this can get
tedious if you have moved many member files.  If you want to move your family
tree, use Save As.  Use Delete from the Main window's project menu to delete
family trees.

3.5

Displaying Pedigree Charts, Descendant Charts, And Family Groups


GenTree can create other documents to show relationships within your family.
There are pedigree charts (Alexandria was born of Samuel and Julie who were
born of...), descendant charts (Margery begat Tom and Sam who begat...), and
family groups (husband, wife, and all their children).


You can create these charts from the main window or the Info windows (Personal,
Family, and Supplemental).  Let's create a descendant chart for Margery Ann
Godsey.  From the main window, select Descendant Chart from the Display menu.
The Descendant Chart requester will appear (see figure).  The requester prompts
you for the ID of the member you want to display.  Enter "1" for the Member ID
and Chart number.  If you couldn't remember, you could have pressed the Member
ID button.  A list of the members in the family tree would have appeared to
choose from (like with the father ID in the Family Info window).  Click
Display.  After a few moments, Margery's descendant chart will appear (see
figure).  The square box on the lower left allows you to view charts which
won't all fit on one screen.


If you click your mouse pointer on one of the names displayed on the chart,
GenTree will create a new descendant chart with that member as the head.  The
left arrow button in the lower left corner loads the previous generation as the
chart head.  GenTree would first prompt you for whether to load the father or
the mother as the head.


Under the Display menu, there are four check mark items: Pedigree, Family
Group, Descendant, and Personal Information.  Please notice that the Descendant
menu item is currently checked.  These menu items control what type of
operation GenTree performs when you click on a name.  Either a pedigree,
descendant, or family group chart would be displayed or the member's
information would be loaded and you would be taken to the Personal Information
Window.  To change the chart, just select one of the menu items, the next time
you click on a name the new operation will be performed.


Finally, under the Display menu t
here is a menu item to print this chart to printer or file.  After you are
finished, click the Close window gadget or select Return from the menu to
return to the main window.


3.6

Printing Your Family Tree


The final thing you need to learn is how to print your family tree.  In the
previous section you learned how to print the pedigree charts et al.  In this
section, you will learn how to print everything.  GenTree allows great control
over which information you wish to print.  You can just print member names (for
a quick list of names and IDs in the database), dates, family relationships,
supplemental information, pedigree and/or descendant charts, and media lists
(and the notes or sources).  The print option creates an ASCII stream of
characters that may be sent to the printer or a file.


GenTree cannot print pictures or sounds (printing a sound would be a trick).
However, lists of the pictures and sounds each member has can be printed.


Select Print...  from the main window's project menu.  The Print Requester will
appear (see figure).  From this requester, you can pick and choose what family
tree information you wish to print.  In addition, you can print all the members
in your database, only updated member records, or only a subset of members.
Clicking the Subset radio button will bring up the Search requester you used in
the Info windows.  From the print requester, you also choose the order of the
members output.  GenTree allows you to sort by name, id, birth date, birth
country, death date, death country, or no sort at all.


After you have configured everything to your liking, click OK.  GenTree will
now display a requester asking where you want the output to go.  The default is
to the PRT: device.  However, you may type in a different destination.
Clicking the Destination button will display a file requester.  When you have
selected a destination, press return or click the Print button to print.

Warning: Printing pedigree or descendant charts for an entire family tree can
take a LONG time.  Be sure this is really what you want to do before selecting
these options.  The options that require member records to be loaded (and slow
print processing thereby) are Family Members, Supplemental Info, Charts, and
Media.


This concludes our tutorial.  Have Fun and Good Luck creating your family tree!


4

Reference


This section provides a reference of the different windows and their functions.


4.1

Main Window


GenTree's main window (figure at right) provides access to the different
windows used by GenTree to enter, print, and display your family tree.  In
addition, the main window is used to read family trees from and write family
trees to disk.

4.1.1


Menus

Project Menu

- Create, open, join, save, delete, and print your family trees.  Also,  modify
GenTree preferences.
New


Create a new family tree.  Any old work will be lost so you will be  prompted
to see if you are sure.
Open...

Open a previously saved family tree saved in GenTree's database  format.  Any
old work will be lost so you will be prompted to see if you are sure.
Join...


Navigates you to the Join Window to join the current database with another
GenTree database saved on disk.  This allows you to concatenate your family
tree with another's.
WARNING: The Join operation, unlike all the edit operations, permanently
changes the database on disk! Be absolutely sure you want to perform a
join or work with a backup copy!
Save


Saves your updates to disk.  If your family tree has never  been created before
a file requester will prompt you for the database name.
Save As...

Saves your current database (and all support files)  to a new database you
specify with a file requester.
Delete...

Deletes a GenTree database (and all support files) from disk.  You cannot
delete the current database in memory.  You need to select new first and then
delete.
Print...


Navigates to the Print window to print information from the current family
tree.
About...

Displays the program version, contact information, free memory, and the number
of members, pictures, sounds, notes, and sources defined in the current family
tree.
Info...


Displays information about the current family tree: the  name of the family
tree, number of members, number of male and female members (note that the sum
of the male and female members may be less than the number of members), number
of pictures, number of sounds, number of notes, number of sources, and the
new/unsaved members.
Preferences...
Navigates to the Preferences window where you can set GenTree preferences.
Quit


Exits the program.  If you have any unsaved data, you will be prompted to see
if you are sure.

Database Menu
- Navigates you to the windows to create, edit, and delete members, pictures,
sounds, notes, and sources.
Update Person...
Navigates to the member entry windows.  If your family tree is not empty, it
brings up a requester to query on records to edit or you may select to create
new records.
Update Picture...
Navigates to the Media Database window where you may update your picture media
database.  If you want to edit personal media database entries, you must enter
the member entry windows.
Update Sound...
Navigates to the Media Database window where you may update your sound media
database.  If you want to edit personal media database entries, you must enter
the member entry windows.
Update Note...
Navigates to the Media Database window where you may update your note media
database.  If you want to edit personal media database entries, you must enter
the member entry windows.  Notes are any text entries about a member or group
of members.
Update Source...
Navigates to the Media Database window where you may update your source media
database.  If you want to edit personal media database entries, you must enter
the member entry windows.  Sources are the references from where you obtained
your family information.

Display Menu
- Display pedigree charts, descendant charts, and/or Family Group forms from
this menu.
Pedigree...

Display the pedigree chart for a member of your family tree.  A pedigree chart
displays a member, his/her parents, grandparents, great-grandparents, etc.  You
are prompted for the member ID for the member to display.  In addition, you may
specify the chart ID.  By default, GenTree builds a pedigree chart with a
generation depth that will fit on the display window using the current display
font (specified in preferences).  You may override this default and state an
explicit number of generations.
Family Group...
Display the Family Group for two member of your family tree.  A family group is
a male (usually the husband), a female (usually the wife), and all their
children (and their wives).  You are prompted for the member ID for the member
and their spouse to display.  In addition, you may specify the chart ID.
Descendant...
Display the descendant chart for a member of your family tree.  A descendant
chart displays all the children of a member, the children's children, etc.  You
are prompted for the member ID for the member to display.  In addition, you may
specify the chart ID.  By default, GenTree builds a descendant chart with a
generation depth that will fit horizontally on the display window using the
current display font (specified in preferences).  You may override this default
and state an explicit number of generations.  The number of descendants per
generation is not limited in any way.  Use the proportional gadget in the
display window to see parts offscreen.

4.1.2


AppEvent


The main window also supports the Workbench 2.0+ App event.  Drop a GenTree
family tree icon on the main window and the family will automatically be
loaded.  The old family tree is erased from memory.

4.2

Member Information And Data Entry Windows


GenTree has three  data entry windows: personal information window, family
information window, and supplemental information window.  These windows are the
heart of the GenTree program.  From them, you create, edit, and delete members
in your family tree.  Each window contains many fields to enter specific types
of information about that member.  In addition, you may connect the current
member to
entries in your media databases.


Each member has a unique ID associated with him/her.  Normally, you do not need
to enter values for the Personal ID.  The only time you need to know entries is
for entering family relationships.  Please see section 2.3 for more details.


When you enter the member entry windows, you will always start at the personal
information window.  If you selected New for your query, you are presented with
a blank page.  If you queried the family tree for a subgroup, you will see the
first record of the sorted query.  The window title displays the member you are
editing and the place within the query list.

4.2.1


Buttons


Next to many of the fields in the member entry windows are invisible buttons
(which ones may be discovered through experimentation).  These buttons display
a list requester (see figure) from which you select the value you want in the
field.  These list requesters provide an easy way to enter information.  You
can use them to standardize your entries as well.  The list requester displays
text files (contained in the GenTree/Lists directory) which you may edit with
any word processor.  The list requester itself allows you to add, delete, and
edit entries and search the list.  Double-click on a entry to exit the
requester and have that value placed in the corresponding field.


The two buttons to the right of the member entry window navigate you to the
other member entry windows.  You cannot leave the personal information window
until an ID, and name have been entered.


The four buttons to the lower left of the member entry windows (see figure)
navigate you to the personal media DB windows.  From left to right, the buttons
navigate you to the picture, sound, note, and source personal media databases.
From these windows, you attach entries in your media databases to the current
member.


The three buttons on the lower right (see figure) display the previous member
of a query list, the next member of a query list, and search the database to
create a query list respectively.

4.2.2


Menus


Each of the three member entry windows have the same general menus and menu
items.  The personal and supplemental information windows additionally contain
Copy and Paste menu items, and the personal information window has New,
Duplicate, and Delete as well.

Project Menu

- Save and configure your family tree.  Display database information, and
return to the main window.
Save


Saves your updates to disk.  If your family tree has never been created before
a file requester will prompt you for the database name.
Info...


Displays information about the current family tree: the name of the family
tree, number of members, number of male and female members (note that the sum
of the male and female members may be less than the number of members), number
of pictures, number of sounds, number of notes, number of sources, and the
new/unsaved members.
Preferences...
Navigates to the Preferences window where you can set GenTree preferences.
Return to Main.
Navigates you back to the main window.  The member record you are working on is
verified and saved to the database.

Record menu
 -
 Create and edit member records.  Go to records within the query.
Undo


Undoes any changes you have made since you entered this window.  Undo does not
restore changes you have made from before entering this window (say, if you had
moved from the personal to the family information window).
Revert


Restores the member record from disk.  All changes made to the member are
deleted.
Verify


Verify the information you have entered about this member.
New


Save the current member and create a new member record.
Copy


Copy the current member to RAM.  All of the member's  information except for
family links and personal media databases are copied.  Copy and Paste are
intended for copying records between family trees.
Duplicate

Duplicate the current member in the family tree.  All information is  copied.
Only the member's ID changes.
Paste


Paste a member you previously copied into this family tree.
Clear


Clear specific fields of the current member: the entire record, personal
information, current spouse, current child, parents, residents, occupations, or
supplemental information.  What fields are available to be cleared is dependent
on the window you are in.
Delete


Delete the current member from the family tree (and delete all family ties).
This function only deletes the member from member.  It is not permanent until
you save the family tree.
Parent

Father


G
o to the record for the current member's father.

Mother

G
o to the record for the current member's mother.
Spouse...

G
o to the record for the spouse of the current member.  If there is  more than
one spouse, you may choose the specific spouse from a list requester.
Child...

G
o to the record for the child of the current member.  If there is  more than
one child, you may choose the specific child from a list requester.
Search For...

G
o to the search requester to perform a subquery on the family tree.
First


D
isplay the first record in the query list.
Previous

D
isplay the previous record in the query list.
Next


D
isplay the next record in the query list.
Last


D
isplay the last record in the query list.

Display Menu

- Display pedigree charts, descendant charts, and/or Family Group forms from
this menu.  By default, GenTree selects the current member ID.
Pedigree...

Display the pedigree chart for a member of your family tree.
Family Group...
Display the Family Group for two member of your family tree.
Descendant...
Display the descendant chart for a member of your family tree.

4.2.3


Windows


From these windows you enter a member's information.  The three data entry
windows are the Personal Information window, the Family Information window, and
the Supplemental Information window.  Use the RETURN key or TAB key to jump
from one field to the next.  The SHIFT-TAB key jumps you to the previous field.
 Any information you need to add for which there is not a field, you should use
the notes media database.

4.2.3.1

Personal Information Window


The personal information window allows you to create, edit, and delete member
records.  You may enter the member's ID, name, gender, birth date and place,
and death date and place.  List requesters exists for the gender, and
birth/death location, city, county, state, country, and cause of death.

4.2.3.2

Family Information Window


The family information window is where you tie your family tree together.  From
here, you select (or create) your member's spouses, children, and parents.
List requesters exists for the spouse ID, child ID, father ID, and mother ID.


The two radio buttons, Spouses and Children, cycle through the member's spouses
and children respectively.  To enter a new spouse or child, press the radio
button until the fields clear.  Do NOT use the clear button; you will delete
the family tie between that member and that relation.

4.2.3.3

Supplemental Information Window


The supplemental information window allows to add supplemental information
about your member.  You may enter the member's different jobs, residences,
military service, religion, immigration information, baptismal and confirmation
dates.  List requesters exist for the occupation type; residence city, state,
and country; immigration
location, and religion.


The two radio buttons, Occupations and Residences, cycle through the member's
jobs and homes respectively.  To enter a new job or residence, press the radio
button until the fields clear.  Do NOT use the clear button; you will delete
the member's job or residence.

4.3

Media Databases


GenTree allows you to link media (pictures, sounds, notes, and sources) to the
members of your family tree.  There are four global media databases (one for
each media type) that hold all media files you have defined in your family
tree.  Each member may also have four personal media databases which point to
specific entries of the global media databases.  Multiple members may use the
same entries from the global
media databases.  Note that this makes it easy to make global changes.

4.3.1


Global Media Databases


The media databases store picture, sound, note, and source references inside
your family tree for coupling with your family members.  Members may have their
own unique references within the media databases, or several members may refer
to the same picture (, sound, note, etc.).  The media databases only store
references, not the actual media.  If you delete or move a media file from
AmigaDOS, GenTree will not be able to find it.


All media types work generally the same except for the source references.
Sources store much more specific information than just the logical name and a
filename.  When you create or update a source, the Source Data Entry window
appears.  See section 4.3.3 for more information on the Source Data Entry
window and how to work with sources.


The sizes of the media databases are limited only by memory.  The more memory
you have, the more references you may have.  However, since GenTree only stores
the physical filename, even in a small memory system you can store hundreds of
references.


You enter references into the media databases using the same media database
window (see figure).  From this window, you may add new entries, update current
entries, edit note and source files using your default editor, and search the
media database for a specific reference.  In addition, double-clicking on an
entry will have that file loaded and displayed (or played if you are using the
sound media database window).

To add picture, sound, or note entries to a media database:
·

Click on the New button.  A file requester will appear.  The default directory
for the file requester is the default directories you specified for the media
in preferences.
·

Select a file using the file requester and click OK.  You may select any type
of  file.  GenTree doesn't restrict the type to allow for new file types
GenTree may not understand, but which your default player or viewer may.
·

Enter a unique logical name for this file and press return.  The logical name
is  what you will use to refer to this media file throughout the rest of the
program.  The logical name may be any characters you wish and has a maximum
length of 255 characters.

Note: The logical name must only be unique for the specific media database;
different media databases may have the same logical name.  Also, the same
physical filename may be referenced multiple times within the same (or even
different) database.  (This is a waste of space, but you may find it necessary
if you want tailored logical names for different members).

To add source entries to the source media database:
·

Click on the New button.  The Source Data Entry window will appear.
·

Enter information into the fields.  You must enter a title (this is the same
thing as the logical name for the other media types).
·

Select OK to exit the window.

To update picture, sound, or note
entries in a media database:
·

Find the entry you want to view/play using the scroll bar or searching for the
logical name.  Highlight your selection.
·

Click on the update button.  A file requester will appear already pointing to
the  file tracked by this reference.
·

If this is the correct file, just click OK.  Otherwise, use the file requester
to find  the correct file and then click OK.  The logical name will then be
shown.
·

Again, you may edit the logical name or leave it as is.  Click OK.

To update source entries in the source media database:
·

Find the entry you want to view/play using the scroll bar or searching for the
logical name.  Highlight your selection.
·

Click on the update button.  The Source Data Entry window will appear with all
the information you have previously filled in.
·

If this is the correct file, just click OK.  Otherwise, change the fields to
what you desire.
·

Click OK to save your changes.

To delete entries in a media database:
·

You cannot directly delete entries in a media database.  Instead, use the
update procedure to overwrite the entry with a new entry.

To view/play entries in a media database:
·

Find the entry you want to view/play using the scroll bar or searching for the
logical name.
·

Double-click on the entry.  If you are in the picture media database window,
GenTree will try to display the picture/brush/brushanim/...  If you are in the
sound media database, the program will try to play the sound.  If you are in
the note or source media database, it will try to display the ASCII text.
GenTree uses the default viewers/players you define in preferences.  If no
viewer/player is defined, GenTree will use its internal routines.  Please refer
to Appendix C to see what file formats are supported.

To edit text files (notes or sources):
·

Find the entry you want to view/play using the scroll bar or searching for the
logical name.  Highlight the entry.
·

Click the Edit button.  GenTree uses the default editor you define in
preferences.  If no editor is defined, GenTree will use MomentED, its internal
ASCII editor.  Please refer to the MomentED section for more details on this
editor.  The filename for the note or source is automatically loaded into the
editor.  Sometimes nothing seems to happen.  Usually, this means that the
editor is not properly defined in preferences.  Editors known to work are ED
and Final Copy II.
·

Make your changes, save them and quit.  To use the editor without loading  any
file (you might want to do this if there are no text files on disk to add),
select the Editor button.

To make a text file (for notes or source information not in the Source Data
Entry window):
·

Click the Editor button to load your editor.
·

Type in your note and save it.
·

Quit the editor.
·

Follow the procedures for adding an entry outlined earlier.

4.3.2


Personal Media Databases


Your members' personal media databases point to specific media tracked within
the media databases.  Each member may have unlimited media connected to
him/her.  Again, you are only limited by memory or disk space.  The personal
media databases are stored in the member file.  If you lose this file, you lose
the links (the entries still exist in the media databases though).


You enter references into a member's record by using the personal media window
(see figure).  This window is only reachable through the member entry windows.
The member you are currently displaying on the member entry window is the
personal media database that you are modifying.  From the personal media
window, you may add entries to your member record, delete entries from the
member (but not the media database itself), edit notes and sources using your
default editor, and search the personal media database for a specific
reference.  In addition, double-clicking on an entry will display (or play) the
entry.  You may also go to the media database window in order to edit the media
database.

To add entries to a member's personal media database:
·

Click on the Add button.  A list requester will appear containing all of the
entries in the relevant media database.  You cannot add entries until entries
exist in the media database.  If you need to add entries to the global media
database, select the Media DB button.
·

Double-click on the entry you want.

To remove entries from a member's personal database:
·

Find the entry you want to view/play using the scroll bar or searching for the
logical name.  Highlight the entry.
·

Click the Remove button.

To view/play entries:
·

Find the entry you want to view/play using the scroll bar or searching for the
logical name.
·

Double-click on the entry.

To edit notes or sources:
·

Find the entry you want to view/play using the scroll bar or searching for the
logical name.  Highlight the entry.
·

Click the Edit button.  GenTree uses the default editor you define in
preferences.
·

Make your changes, save them and quit.  To use the editor without loading  any
file (you might want to do this if there are no text files on disk to add),
select the Editor button.  Any changes you make to the file will be reflected
for all member personal databases that reference that file.

4.3.3


Source Data Entry Window


This window (See figure) provides you with fields for completely entering
source information.  Sources represent the submitter's justification for the
opinions asseted in the family tree.  It provides the evidence obtained for the
information and gives an idea of how much confidence other genealogists can
have in the data.  The Title field is the same as the logical name for the
other media types.  It is the only required field.  Other fields are optional
and depend on the classification of the source.

4.3.3.1

Buttons


Next to many of the fields are buttons which will display a list of choices for
that field.  Click the button and select the choice (by double-clicking on the
choice or highlighting the choice and selecting OK).  The following fields have
lists: classification, quality, fidelity, originator type, and publication
type.

4.3.3.2

Fields


The following fields enable you to meet the minimum standards for defining
source references for a family tree.

Classification.
A code which classifies the source which contained the evidence data.  For
example, an official census or a church record.
Title


A descriptive string for the source.  For example, 1890 Census Records.
Quality

The submitter's assessment of he reliability of the source.  Please use the
list requester for this field.
Fidelity

A code which provides an assessment of the exactness of the source material.
For example, an original record being cited, a photocopy of the original, a
transcription of the original, or an abridgement of the original.
Page Description.
A description which i
dentifies the page within the source.  It may be a page number, range, or
anything other description of hor to find the referenced information within the
source.  For example, Page 212 - middle paragraph.
Originator Name.
The name of the person or organization that created the source.  For example,
the US Government.
Originator Type.
The type of organization or person that created the source.  For example,
author, organization, or interviewer
Publication Title.
The name of the publication such as a book name, periodical name, or newspaper.
 For example, The Washington Star.
Publication Type.
The type of publication that is the source.  For example, a book, periodical,
newspaper, etc.
Publication Publisher.
The name of the publisher that created the source.  For example, Simon &
Schuster.
Publisher Address.
The address of the publisher that created the source.
Publication Date.
The date the source was published.  For example, 12-May-1800.
Publication Edition.
A description of the specific version of the publication being referenced.  For
example, 2nd Printing.
Physical Filename.
An optional file that may be attached to the source.  It may be any type of
file: a picture of the evidence, a descriptive voice annotation, etc.

4.4

Genealogical Charts


GenTree provides genealogical charts for outputting your family tree.  You can
display pedigree charts, descendant charts, and family groups.  You can create
these charts from the main window or the member entry windows.

4.4.1


Pedigree Charts


Pedigree charts lists a member's pedigree (i.e.  parents, grandparents, great
grandparents, etc.) To display a pedigree chart, select the pedigree menu item
from the display menu.  A requester (see figure) will appear prompting you for
whom you want to display.  You must enter a member ID.  There is a list
requester available by pressing the Member ID button.  In addition, you may
enter the chart ID and the number of generations to display.  By default,
GenTree displays as many generations as will fit on the display screen using
the display font (set in preferences).  For each member displayed in the
pedigree chart (except the last generation), GenTree displays the ID, name,
birth/death date and place, and, under the male, the marriage date if any.
Finally, you may turn off the display of birth/death place by deselecting the
check-marked button.


After clicking the Display button (or hitting carriage return), the pedigree
information will be compiled and displayed.  Click the close button to exit
back to your window.

4.4.2


Descendant Charts


Descendant charts show the descendants of one member (his/her children, their
children, etc.) To display a descendant chart, select the descendant menu item
from the display menu.  A requester (see figure at left) will appear prompting
you for whom you want to display their descendants.  You must enter a member
ID.  There is a list requester available by pressing the Member ID button.  In
addition, you may enter the chart ID and the number of generations to display.
By default, GenTree displays as many generations as will fit on the display
screen horizontally using the display font (set in preferences).  For each
member displayed in the descendant chart, GenTree displays the ID, name, and
the birth/death dates and places.  You may turn off the display of birth/death
places by deselecting the check-marked button.


After clicking the Display button (or hitting carriage return), the descendant
information will be compiled and displayed.  Click the close button to exit
back to your window.

4.4.3


Family Groups


A family group shows one family i.e.  a father, a mother, and any children.  To
display a family group, select the family group menu item from the display
menu.  A requester (see figure at left) will appear prompting you for a member
and their spouse to display.  You must enter the member's ID.  There is a list
requester if you forget available by pressing the Member ID button.  There also
exists a spouse ID requester which will list all of the spouses of the member
in the member ID field.  Members without a spouse may leave the spouse ID field
blank.  If the member has a spouse, you must enter the ID.  Finally, you may
enter the chart ID for recordkeeping purposes.


After clicking the Display button (or hitting carriage return), the family
group information will be compiled and displayed.  Click the close button to
exit back to your window.

4.4.4


Printing Charts


You may also print your charts and family groups.  The charts may be output to
file or to the printer.  If you want to output to the printer, GenTree uses the
application specified in the GFXPrint field for preferences.  The default
printing application is GenTree's internal application.  For other printer
application, GenTre
e will grab
 the screens for the charts, save them to RAM, and create a script file
containing the filenames and paths.  The script filename is inserted into the
GFXPrint screen at the asterisk.  For example, "SYS:Utilities/Display from *
opt bp t=1" becomes "SYS:Utilities/Display from Ram:T/GT/scriptlist opt bp
t=1".  This string is fed as a CLI command to AmigaDOS.

To print a chart or family group:
·

Display a chart/group using the  procedure outlined in the previous sections.
·

From the Display screen, select  Print from the menu.  A print requester will
appear (see figure previous page).
·

Click the print button to send the output to the printer.  If you want the
display  to go to file, click the Destination button and fill in a path and
filename first.

4.5

MomentED


The Moment Editor (MomentED) is a full-featured ASCII editor integrated into
the GenTree program.  It is called the Moment Editor because it took me only a
"moment" to create.  MomentED provides a superb example of CanDo; it took me
approximately 3 days to complete.  MomentED provides the following features:

·

Document sizes are limited only by memory
·

Unlimited number of documents open at once (again limited by RAM)
·

Undo feature
·

Block and line copy and paste in same document or between documents
·

Sort Document or block in ascending order ignoring case
·

Find and Replace utilities


If you have used a word processor or text editor before, you will be entirely
comfortable with MomentED.  You access the editor by selecting the Edit or
Editor button from the Media windows (Personal or Global).  The current
document's name is displayed in the window title bar.


Here is a list of MomentED's menus and their functions:

Project Menu
- Create, open, and save documents.
New


Create a new, blank document.  The new document will become the current
document.  Other documents in memory are not lost.
Open...

Open a previously saved document.  The opened  document will become the current
document.  Other documents in memory are not lost.
Close


Close the current document.  If there are other documents available, MomentED
will swap to one of those.  Otherwise, a new, blank document will appear.
Save


Save the current document using the current name.  Only the current document is
saved.
Save As...

Save the current document using a new name.  A file requester appears from
which you select the path and filename.  Only the current document is saved.
Print...


Print the current document.  A requester appears from which you may specify the
destination of the document.  The default destination is the printer.  Only the
current document is printed.
About...

Displays the version of  MomentED.  In addition, memory usage, the number of
documents loaded, and the size of the current document (in characters and
lines) are displayed.
Quit...


E
xits the program.  If any of  the documents currently loaded have been changed,
you are requested to see if you are sure.

Edit Menu
 - Edit the document.
Undo


Undo your last change.  Beware, switching between documents means you cannot
undo your change.
Cut


Cut the currently selected block from the document.  You must first select a
block using the mark begin and end keys (detailed below).
Copy


Copy the currently selected block from the document.  You must first select a
block using the mark begin and end keys (detailed below).
Paste


Paste the block you cut, copied, or sorted at the current cursor position.
Sort block

Sort the currently selected block.  The block is sorted on the first character
of each line of the block in ascending order.  The case of words is ignored.
Clear


Clear the current document.

Utilities
- Modify text for the document.
Find...


Displays the Find Requester (see figure).  You can search for characters by
word or string, case-sensitive or not.
Change...

Displays the Change requester (see figure).  From this requester, you can
search for an occurrence of a certain string and replace it with another
string.  You have the option of searching by word or string and
withcase-sensitivity or not.  After the string is found, you have the option to
make the change, skip this occurrence, or replace all occurrences.
Margins...

Displays the Margin requester (see figure next page).  From this requester, you
can change the margins for the entire document.  You specify the left margin
and the right margin.  Any left margin greater than one will cause all lines to
have spaces inserted on the left to "left justify" the lines.
Sort


Sort the entire current document.  The document is sorted on the first
character of each line in ascending order.  The case of words is ignored.

Window Menu
 - Display help screen or switch the current document.
Help


Displays the help screen listing all hot keys for the editor.
Select...

Displays a list requester allowing you to select the current document.
First


Swaps the current document with the first document in memory.
Next


Swaps the current document with the next document in memory.
Previous

Swaps the current document with the previous document in memory.
Last


Swaps the current document with the last document in memory.

Here is a list of MomentED's hot keys and their functions:
Ctrl-[


Select the start point of a block.  This key is used with the Ctrl-] key to
delimit a block.  After you have delimited a block, you can cut, copy, or sort
the block.
Ctrl-]


Select the end point of a block.  This key is used with the Ctrl-[ key to
delimit a block.  After you have delimited a block, you can cut, copy, or sort
the block.
Ctrl-Y


Delete the current line.
Alt-Y


Paste the line last deleted at the current cursor position.
LeftAmiga-Y

Delete from the current cursor position to the beginning of  the line.
RightAmiga-Y.
Delete from the current cursor position to the end of the line.
Ctrl-X


Clear the current line.  A blank line is left where the line used to be.
Ctrl-Up

Move the cursor to the top of the document.
Ctrl-Down

Move the cursor to the bottom of the document.
Ctrl-Left

Move the cursor to the beginning of the current line.
Ctrl-UP

Move the cursor to the end of the current line.
Shift-Up

Move the cursor up one page of the document.
Shift-Down

M
ove the cursor down one page of the document.
Shift-Left

Move the cursor to the beginning of the previous word.
Shift-UP

Move the cursor to the beginning of the next word.
Help


Display help screen.

4.6

Preferences


GenTree allows extensive control over the appearance and behaviour of the
program.  From a preferences screen, you can change fonts, fontsizes, default
directories, and other parameters.

4.6.1


Defaults


On start-up, GenTree uses the preferences specified in the GenTree.Def file
(contained in the same directory) or, if it cannot find this file, internal
default preferences.  This way, by using the GenTree.Def file, you can set up
default preferences for the start of each session.  In addition, every family
tree you create contains the preferences used at the time you saved it.


The preferences window (see figure) allows you to change any of GenTree's
preferences.  Listed below are the preferences, their definitions, and their
defaults as specified internally:
Font


This parameter specifies the font used in all GenTree execution windows except
the Chart Display window.  Any font in your FONT: directory may be used (even
outline fonts).  The Default font is "Times".
Font Size

This parameter specifies the size of the default font.  The default font size
is 11 points.
Display Font

This parameter specifies the font used in displaying family groups and charts.
Any font in your FONT: directory may be used (even outline fonts).  The Default
font is "Times".
Display Font Size. This parameter specifies the size of the display font.  The
default display font size is 11 points.
Year Range

This parameter is used with the search requester.  When you specify About in
the birth or death date, GenTree will search for members that satisfy that date
plus or minus Year Range years.  This number must be an integer.  The default
value is plus or minus 5 years.
Report Labels Justification.  This parameter controls how the labels in a
printed report appear: either left-justified, right-justified, or centered.
The default value is left-justified.
Put Page Breaks in report?  This parameter controls whether a line feed or a
page break is placed between every member output in a report.  The default
value is false.
SEENOTES is TRUE for sorts?  This parameter controls how GenTree interprets the
date format: SEENOTES.  When sorting, if this option is true, the SEENOTES
dates will always be less than, greater than, or whatever the sort is.  The
default value is true.
Create Icons?
This parameter controls whether or not GenTree creates an icon for your family
tree when it is saved or when something is "printed" to a file.  A check means
that icons will be created.  The default is on.  This parameter is closely
related to the All Products parameter.
All Products? This parameter controls whether or not GenTree creates icons for
all files it produces.  Since GenTree makes a file for every member in your
family tree, this option should be left off.  However, for those who just need
to waste disk space this option exists.  A check means that icons will be
created.  The default is off.
Convert Dates? This parameter controls when GenTree converts dates whether or
not it will display the GenTree default date format.  By leaving this option
off, GenTree will still validate dates.  However, the text string you input
will remain.  This allows you to use display date formats you are more
comfortable with (for example, spelling out the entire month).  The default is
on.
Compare Full Dates?  This parameter controls how GenTree compares dates.  When
this option is true, GenTree uses the date modifiers (After, Before, Between,
and About) and tries to figure out which date is less than (or greater than)
another.  This can get tricky if GenTree is comparing dates like After 1990 and
Before 1991.  This options make sorts take longer since the logic is harder.
The default value is true.
Display Birth/Death Locations? This parameter is used when GenTree generates
charts or family groups.  You can save space on the display by not showing the
birth and death locations in your charts.  The default is on.
Default Directories (pictures, sounds, notes, sources, and persons). These
fields specify the default directories for where GenTree first looks for that
type of file.  Do not fill in the filename! In the case of the persons
directory, the parameter controls where any new members will be saved when you
next save the family tree.  This allows you to save new members on different
disks (or directories) as available space is used up.  The defaults for these
directories are the directories located in the GenTree default directory.
Notes & Sources -- Editor -- This parameter specifies the default editor to use
whenever you want to edit a note or source.  Leaving this field blank uses the
internal GenTree editor, MomentED.  Note that you must give the full path and
editor name AND, if any spaces exist, you must surround the path and file with
quotes.  When you select a file to edit, GenTree appends the filename to this
field and tries to run it.  The default is to use MomentED.
Note: I have successfully tested Final Copy II and Ed.
Notes & Sources -- Viewer -- This parameter specifies the default text viewer
to use whenever you want to view a note or source.  Leaving this field blank
uses the internal GenTree text viewer.  Note that you must give the full path
and viewer name AND, if any spaces exist, you must surround the path and file
with quotes.  When you select a text file to view, GenTree appends the filename
to this field and tries to run it.  The default is to use the internal text
viewer.
Note: I have successfully tested More and MuchMore.
Pictures & Sounds -- Viewer -- This parameter allows you to extend the
functionality of GenTree by using a third party picture viewer, to display
formats not supported, GIF, JPEG, IFF24, etc.  Leaving this field blank uses
the internal GenTree picture viewer.  Note that you must give the full path and
viewer name AND, if any spaces exist, you must surround the path and file with
quotes.  When you select a picture to view, GenTree appends the filename to
this field and tries to run it.  The default is to use the internal viewer.
Note: I have successfully tested and use ViewTek (VT).  I heartily recommend
using this excellent viewer.  With it, you can display JPEG, IFF24, and full
screen animations.


You may also place the filename of an AREXX script in this field.
Pictures & Sounds -- Player -- This parameter allows you to extend the
functionality of GenTree by using a third party picture sound player, to play
formats not supported.  Currently, GenTree will only play IFF 8SVX.  Note that
you must give the full path and player name AND, if any spaces exist, you must
surround the path and file with quotes.  When you select a sound to play,
GenTree appends the filename to this field and tries to run it.  The default is
to use the internal player.
Note: You may also place the filename of an AREXX script in this field.
Pictures & Sounds -- GFXPrint -- This parameter controls the printing of your
charts and family groups from the charts window.  GenTree uses the value in
this field to print the IFF of the screen.  GenTree saves the screens to RAM
and creates a file called ScriptList.  This file lists all files to print.
When you select print, GenTree inserts the path and name into the GFXPrint
string.  The name is inserted at the asterisk.  The current default is
GenTree's internal code.  Another default might look like
"SYS:Utilities/Display from * opt bp t=1." This assumes that Display is in your
utilities drawer.

4.6.2


Changing The Defaults


You may change any preferences using GenTree's preferences window.  Some
parameters you modify by checking on/off the button.  Others require text
input.  Buttons next to parameter fields display requesters to aid you in
filling in proper text.  The Font and Display Font buttons will display the
fonts contained in your FONT: directory.  Double-click on the font you wish to
use.  The Font Size and Display Font Size buttons display the sizes available
for that font.  For outline fonts, a standard list of sizes is displayed.
Under WB 2.0, you may use font sizes not specifically available for that font.
The directories and media buttons display a file requester for you to find the
relevant
file/directory.

4.7

Joining GenTree Databases


GenTree provides the ability to join family trees to make one colossal family
tree.  In fact, if you wish to enter a GEDCOM tree into your database, joining
is the only way to do so.  After GenTree converts the GEDCOM file to GenTree
format, you combine the new tree to your own family tree.  You don't have to
join your family tree with the entire other family tree, GenTree allows you to
perform subqueries on the joining family tree before adding it to yours.


To join family trees, you must have a family tree already loaded.  After
loading your family tree, select Join...  from the project menu of the main
window.  The Join window will appear (see figure) which is where you control
how the two family trees are joined.  The very first thing you must do is find
the GenTree database you want to add.  The field at the top of the window
informs you what family tree you are adding.  You can change this database if
you want.


By default, GenTree wants to join every member from the entire newdatabase with
your current GenTree database.  However, you can select only a subset of those
members by pressing the Subset of members radio button.  GenTree will bring up
the Search requester where you may limit the members to join.  Also by default,
GenTree only imports members, not any of the media databases.  If you want to
combine the media databases as well, check the appropriates boxes.


When everything is to your satisfaction, click the OK button and GenTree will
join the two databases.  You will then need to go into the Personal information
windows to update the links between the families or to delete any unnecessary
members.

Warning! The join operation is irrevocable.  GenTree creates new member records
on disk (or whereever the Persons Dir is set in the preferences window) and
saves the database.  If you are not sure of what you are doing, use a working
copy of the your family tree instead.

4.8

Printing GenTree Databases


Genealogical information would not be as useful if you couldn't print it out.
So, of course, GenTree provides a printing capability.  Using the print option,
you can dump all or portions of your family tree to the printer or to a file.
This print file is an ASCII file which you may later edit.  If you want to
print the graphic pedigree charts or other charts you made, use the print
option from the display window.


To print your family tree, select Print...  from the project menu of the main
window.  The Print requester will appear (see figure).  From this requester,
you decide exactly what portions of your family tree to print.


Select the All Members (default), Subset of Members radio button or Only
Updated Members radio button to choose what members to print.  If you select
the Subset of Members button, GenTree will provide the Search Requester for you
to choose the criteria by which members are selected.  This is the standard
search requester used throughout GenTree allowing you to query by ID, name,
gender, and birth/death dates and countries.  If the Only Updated Members
button is selected, only members changed since the last save will be printed.
You can get a list of changed member records by choosing the Info... menuitem
from the main window.


The two buttons on the right control in what order the members are printed.  By
cycling through the options, you can print the members unsorted or sorted in
ascending/descending order by ID, name, gender, birth date, birth country,
death date, or death country.


Finally, all the check boxes at the bottom control what parts of a member's
information is printed.  A check in the box means that option will be printed.
The options are explained below:
Members

Checking this box displays the members' names and IDs.  If this box is
unchecked you cannot select the Dates, Places, Family Members, Supplemental or
Charts boxes.
Birth & Death Dates. Checking this box displays each members' birth date and
death date.
Birth & Death Places. This box controls the display of each members' birth
place and death place.
Family Members. Checking this box displays for each member their spouses,
children, father, and mother.  These members may be displayed later, but this
shows the relationship, the family ties.
Supplemental. Checking this box displays all the information you entered in the
supplemental information window for each member printed.
Pedigree Charts. Checking this box directs GenTree to build a Pedigree chart
for each member displayed.  The pedigree chart is not graphical, rather it
shows the relationships through text placement.  This option increases the time
to print dramatically since GenTree must get multiple records for each member
it prints.
Descendant Charts. Checking this box directs GenTree to build a Descendant
chart for each member displayed.  The descendant chart is not graphical, rather
it shows the relationships through text placement.  This option increases the
time to print dramatically since GenTree must get multiple records for each
member it prints.
List Pictures

Checking this box will display the logical names of all the pictures associated
with each member printed.
List Sounds

Checking this box will display the logical names of all the sounds associated
with each member printed.
List Notes/Full Notes/No Notes. This button cycles through 3 options for
displaying notes.  List Notes displays the logical names of the notes
associated with the member.  Full notes displays the entire note of all the
notes in the member's personal note media database after the member.  No Notes
displays nothing from the members' note database.
List Sources/Full Sources/Refer Srcs to EndNotes/No Sources. This button cycles
through 4 options for displaying sources (references).  List Sources displays
the logical names of the sources associated with the member.  Full Sources
displays the entire source text of all the references in the member's personal
note media database after the member.  Refer Srcs to EndNotes displays, for
each printed member, the logical names of the sources referenced in their
personal media database and prints the entire source text at the end after all
members have been printed.  No Sources displays nothing from the members'
source database.


GenTree v1.5 Documentation

© 1995, Thomas G. Grubb











































1

Appendix A

Date Formats


Many places in the program you have to enter dates.  GenTree is very flexible
about the format of these dates.  The basic date format is
[Qualifier] DD-MON-YYYY [AD/BC]
or
Between DD-MON-YYYY and DD-MON-YYYY
or
Seenotes
where Qualifier is About, Before, or After
Between, And, and Seenotes are literals
DD is the day, 1 or 2 digits
MON is the at least first three letters of the month
YYYY is the complete year (i.e.  1993, not 93).
AD/BC are optional qualifiers, Anno Domini and Before Christ respectively
For example, About 16-Apr-1993 is a valid date.

The rules for date formats are:
·

The Qualifiers;
About
,
Before
, and
After
; may be used with any legal date.   Examples: "About 1892", "Before Jan 1900",
and "After 100 BC".
·

The qualifier combination,
Between-And
, cannot be used in combination with any of the other qualifiers i.e. "Between
About 1990 and 1991" is not legal.
·

Valid elements of a date may be in any order.  The only exception is the
Between-And range date; the qualifiers must be in their correct position.
Examples: "Jan 27 1993", "1993 Jan 27", "27 Jan 1993 About".
·

Valid elements must be separated by any non-alphanumeric character.  Examples:
"7/August/1993", "Jun,3,1992", "About&3&Jun&1993".
·

Two or one digit years must have leading zeroes in front.  Examples: "072  AD",
"003 BC", "Before 001 AD".
·

Years may be entered alone (without month and day).  Year and Month may be
entered alone (without day).  If you enter a day, you must have the month and
year.  Examples: "1966", "Aug 1966".
·

Seenotes cannot be used with anything else.  This date should be used when you
have a format that cannot be handled by GenTree.
·

Double dating is NOT supported i.e.  "Jan 12 1772/1773".
·

Dates are not case-sensitive.


When entering dates in GenTree fields, hit return to have the date format
verified immediately.  If there is something not understood, you will be
notified.  In addition, if you have set the Convert Date format in preferences,
GenTree will translate your date to the format above.
GenTree v1.5 Documentation

© 1994, Thomas G. Grubb











































A1

Appendix B

GEDCOM


GenTree supports the Genealogical Data Communications standard for transferring
genealogical information between different genealogy programs (and different
types of computers).  Currently, GenTree supports the draft release 5.3 of the
GEDCOM standard.  GenTree supports the standard by the utility
GEDCOMConverter
provided when you register GenTree.

To import a GEDCOM file for GenTree's use:
·

Start the GEDCOMConverter utility.  Import a GEDCOM file by following the
instructions which come with the utility.  Quit the application.
·

Start GenTree
·

Open the Gentree database created with GEDCOMConverter.
·

Check the Notes Media Database for any processing notes.  GEDCOMConverter
creates notes for any parts of the GEDCOM file it does not understand.  If
necessary, use the notes to guide you in cleaning up the records of the family
tree.
·

Use the Join menu item to join the GEDCOM family tree to your family tree.

To export a GenTree database to a GEDCOM file:
·

Start the GEDCOMConverter utility.
·

Follow the instructions that come with the utility.

GenTree v1.5 Documentation

© 1994, Thomas G. Grubb











































B1

Appendix C

GenTree Supported File Formats


GenTree deals with many different types of files to perform its function.  This
section overviews the file types GenTree directly supports for its media.
Please note that GenTree can support other file types by using other programs
(VT is an excellent choice for the picture media...  It handles regular IFFs,
JPEG, brushes, full screen anims, etc.).

Pictures:
All normal Amiga formats: HiRes/LoRes, (non)Interlace, AGA, HAM, and brush
animations.  AGA is only available when running GenTree on an AGA Amiga.
S
ounds:
IFF8SVX
Text:
Any file...  Vanilla ASCII files will look the best though.



GenTree v1.5 Documentation

© 1994, Thomas G. Grubb











































C1

Appendix D

Future Plans


GenTree is a powerful genealogical program, but there is definitely room for
improvement.  If people really like it and support it, I would like to
implement the following improvements (in general order of importance):

·

Make printing prettier.
·

Make the Family Information Window graphical.
·

Add AREXX support.
·

Improved charts and more types, with integration of the chart with pictures.
·

Improved speed and better data organization.
·

Add more data inconsistency checks.  Also, make them more efficient.
·

Make an AGA-specific version of GenTree.
GenTree v1.5 Documentation

© 1994, Thomas G. Grubb











































D1

Appendix E

About The Author And Development


The original
GenTree v1.0 was developed by myself over an 9 month period.  The bulk of the
coding was completed in 6 months with cleanup and documentation
taking another 3 months.  GenTree was completed on free time: nights and
weekends.


The original
GenTree v1.0 was developed with CanDo 2.0 running on an Amiga 2000HD with 13
Megs of RAM and GVP's 33MHz 68030.  Since then, the development system hasn't
changed, but Inovatronics (the developers of CanDo) has been busy updating
CanDo.  This program would never have been developed if it wasn't for CanDo.
CanDo is a marvelous development tool, and it has only gotten better in each
incarnation.  I cannot recommend it highly enough.  GenTree v1.0 had a few
quirks in it because of CanDo 2.0.  Generally, Inovatronics have gotten rid of
the limitations of 2.0 (If I was developing GenTree from scratch today, I would
do it
much
differently).  However, CanDo still has a few limitations.  Just in case a
CanDo developer reads this, I am going to list the features I'd like to see
(ignore this if you don't have CanDo):
·

You cannot change the text of a menu item.  For example, I wanted to change
the Undo menu to be context-sensitive; "Undo typing", "Undo Paste", etc.
·

You cannot add menu items later.  All menu items must be completely defined at
development time.  I had wanted to be able to have users define macros, and as
each macro was defined, add it to a macro menu.
·

No access to the clipboard.  I would love to be able to cut to and paste from
the clipboard device.
·

Printer management of graphics is terrible.  CanDo should allow graphic
operations' output to be written to a postscript file which could later be sent
to a postscript printer.
·

No access to system preferences.
·

Speed.  This is not one of my biggest gripes.  Currently, CanDo achieves
adequate performance on a 68020 or above.  However, it would be nice to be able
to truly compile the project.
·

Variable window coordinates and size.  CanDo currently works by opening  your
window and sizing it based on constants you define in development.  You cannot
move or resize your window until it has been opened.  I would like to be able
to change the size and position of the window in the before attachment script
so that the window doesn't flash open and then move to where I want it.

GenTree v1.5 Documentation

© 1994, Thomas G. Grubb











































E1

Appendix F

Suggestions, Comments, And/Or Bug Reports

Any suggestions, comments, and/or bug reports should be sent to:
Thomas G.  Grubb
15439 Empress Way
Bowie, Md. 20716 USA
If it is a bug, please include as much information as possible so that I may
recreate the bug.  If you leave an email address, I will try to reply promptly.
 I will do my best to incorporate your requests into a future release.  Thanks,
I hope you like the program and find it useful.

GenTree v1.5 Documentation

© 1994, Thomas G. Grubb











































F1

Appendix G

Version History

August 1993


Original Release: GenTree v1.0

March 1995

GenTree v1.5
·

Added Quality of Data fields
·

Improved the Sources database
·

Added Cause of Death
·

Added Navigation to the Chart Screen.  If you click on a name, GenTree will
build a new chart with that person as the root.
·

Added optional spouse ID to the Descendant Chart.  If the spouse ID is
specified, only the descendants of the two people will be shown.  Otherwise,
all descendants of the member will be shown.
·

Added context sensitive help.  Hold down the F1 key and then select a gadget or
menu item for context sensitive help.
·

Created a stand-alone GEDCOM <--> GenTree Import/Export
·

Fixed Sound and Source Database Bug.
·

Improved operation of program by using new CanDo AskForResponse Requester.
·

Used new printwindow command in CanDo for printing charts.  The Display program
is no longer needed.
·

Added Owner Information to preferences.
·

Added Report options to preferences: form-feeds between member records and
label justifications
·

Added SEENOTES as a valid date.
·

Added BETWEEN date AND date as a valid date.
·

Added one-line help text for the fields in the personal data entry windows.
·

Added Cancel option to the Search requester.
·

Added Gender field to the child's information in the Family Information Window.
·

Includes support for TAB and Shift-TAB through fields
·

Added Print Updated Members button to print requester
·

Fixed bug where changed information would be lost if you selected "Display
Pedigree/Descendant/Family Group" chart frrom the Data Entry windows.

GenTree v1.5 Documentation

© 1994, Thomas G. Grubb











































G1